home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
qbbs
/
rafbst20.zip
/
RAFBSTAT.DOC
< prev
next >
Wrap
Text File
|
1990-11-04
|
9KB
|
285 lines
------------------------------------------------------------------------------
RaFbStat v2.0
Files Database Statistics Bulletin Generator
Copyright (C) 1990 Foxtrot Software
All Rights Reserved
This is a shareware program, this program is not to be sold or modified
in any way. You are free to use, copy and distribute RaFbStat as long as:
a. No fee is charged for use of the program or the documentation.
A fee may be charged for copying or distibution of this software
and documentation for others not to exceed US$ 10.00.
b. It is not modified in any way.
c. This software and documentation or either is not used commercially.
d. You distribute this software along with all documentation and
registration forms unmodified.
The Author hereby disclaims all warranties relating to this software,
whether expressed or implied, including without limitation any implied
warranties of merchantability or fitness for a particular purpose. The
author will not be liable for any special, incidental, consequenctial,
indirect or simular damages due to loss of data or any other reason. The
user of this software bears all risk as to the quality and performance
of this software.
-------------------Now that we have that out of the way-----------------------
If you have any comments or suggestions for improvement of this software,
you can contact me at The Foxtrot BBS, data: (914 )567-1814, 24 hours a
day or leave Net-Mail @FIDO NET 1:272/26, @MagNet 100:900/39, @IS-Net
40:1914/1 or 40:1914/12.
If you like this software, and decide to keep it on your system and
to use it, then send $8.00 (Check or M.O.) for registration to the address
listed below.
Copies of all source code for RaFbStat is available. Please write or NetMail
me at the following addresses for more information on this offer:
Foxtrot Software or Byron Copeland
11 Y Street The Foxtrot BBS (1:272/26)
New Windsor, Ny. 12553 Data: (914)567-1814 24 hours
Thank you for your support.
------------------------------------------------------------------------------
1. Introduction.
RaFbStat is a utility that will allow the Sysop of a RemoteAccess BBS
to produce a Files Area Statistic Report of the following:
1) Total files in all selected areas.
2) Total bytes in all selected areas.
3) Total files for each area selected.
4) Total bytes for each area selected.
5) Percentage of the total files that each area contains.
Selected areas are determined by using Security and Flags settings
configured in the RAFBSTAT.CTL file. Areas that don't match the criteria
specified will not be processed.
The report is usually placed in same directory as all other text files
so a menu option can be built to allow a user to view the Bulletin.
RaFbStat is designed to be run during a maintenance event when no
callers are using your system. Thus, RaFbStat has no code to handle
file sharing in a multitasking environment.
This version of RaFbStat is for use with Version 0.04a of RemoteAccess
BBS and versions that conform to the structs of that version.
2. Version 2.0 Enhancments.
1) Automatic RA System Area detection.
2) Allow user control of which .Ctl file to use for execution.
3) Security and Private Security checks now configurable.
4) Flags and Private Flags now configurable.
3. Files needed by RaFbStat:
INPUT:
FILES.RA - The filename of your Files Configuration.
RAFBSTAT.CTL - Control file for RAFBSTAT. Or any .CTL file
that is defined on the command line when executed.
OUTPUT:
BULLETIN.ANS
BULLETIN.ASC - A bulletin file that you will specify in
RAFBSTAT.CTL file. Actually two files will
be created as output. One is a plain ascii
file, the other will contain ansi screen
commands for color. When specifying the
filenames, DO NOT append .ASC or .ANS.
RAFBSTAT will append an extension for you.
4. Setup.
a. An Editor that will create text files, such as EDLIN, GALAXY,
or any Editor that will allow CR/LF combinations at the end of each
line has to be used. Create the RaFbStat.Ctl file in your RA BBS
System directory with the following information:
Line 1: Full Pathname of the Bulletin filename you wish to use.
Line 2: Name of your BBS. (55 Chars max)
Line 3: Security required to be processed.
Line 4: Security Flags required to be processed.
Line 5: Private Security Level required to be processed.
Line 6: Private Security Flags required to be processed.
Line 7 - 26: File Extensions that you wish to have included in the
Bulletins.
An example of the RaFbStat.Ctl File:
BULLETPATH : D:\RA\Txtfiles\Bullet10
BBSNAME : The Foxtrot BBS * New Windsor, Ny.
NORMALSEC : 10
NORMALFLAGS: -------- -------- -------- --------
PRIVSEC : 100
PRIVFLAGS : -------- -------- -------- --------
EXE
ZIP
LZH
ARC
PAK
TXT
DOC
ZOO
5. Security Flags.
a. Flags and PrivateFlags take on the following meaning:
- The flag must be off to be accepted.
X The flag must be on to be accepted.
? Don't care what the flag state is.
Example:
---X--X- ?-??---- -------- --------
To process this area record then Flags A4 and A7 must be on.
Flags A1-A3, A5-A6, A8 must be off. Flags B2, B4-B8, C1-C8, D1-D8
must be off. The state of Flags B1, B3-B4 are disregarded.
b. How to run RaFbStat:
Usage: RaFbStat [<-F Path>]
-F Path - Using this argument will allow you to specify
a different path for the .CTL file other than
the default RAFBSTAT.CTL.
c. RaFbStat.Exe need not exist in the RA System directory to
generate the bulletin(s). But if your are executing RaFbStat
without any arguments, then RaFbStat.Ctl must exist in the
current directory you are executing it from.
Note: If you have areas that are not in use, then make sure that they contain
no characters in the name or File Path description of the FILES.RA
record for that area.
6. Problem(s) History:
10/08/90 - First Release.
v1.0
10/09/90 - Bug. Run time error 200 occurred at 0000:1D17. This was
v1.1 cause by the grand total files being a zero value and
being divided into the file count for the area to
produce the percentage.
Fix. Put a trap in the code to not divide when Grand Total
is zero.
10/13/90 - Bug. I found that sometimes that the code used to find
v1.2 the files specified in the RaFbStat.Ctl file also
included the directories where the files were in
the Grand Total File Count. Although this would
not cause problems for anyone, it does randomly
produce incorrect values.
Fix. Checked file attribute for a directory entry and
bypass tally logic if true.
Other Quality Software Products for SysOps are:
Magic name Description
RaTop Top 10 - 100 Users bulletin maker for RemoteAccess.
QuikTop Top 10 - 100 Users bulletin maker for QuickBBS 2.62+
OpusTop Top 10 -100 Users bulletin maker for OPUS CBCS 1.1x.
PROBLEMS:
Please notify me immediately if you have any problems or
suggestions about this program. Enhancements are being incorporated
all the time and your input is more vital to this process than you
think. You may write me, send Net-Mail or logon at the following address:
Foxtrot Software
C/- Byron Copeland The Foxtrot BBS
11 Y Street (914) 567-1814 @Fidonet 1:272/26
New Windsor, Ny. 24 hours a day!
12553
ACKNOLEDGEMENTS:
Thanks to the people that were patient and critical at times. But who helped
make this software a better product:
Jeff Doolittle 40:50/1 40:1914/11
Jamie Ferrara Pending
Eddie Bryant 1:360/13
Enjoy and thank you for your support!
- End -